home *** CD-ROM | disk | FTP | other *** search
/ Games of Daze / Infomagic - Games of Daze (Summer 1995) (Disc 1 of 2).iso / x2ftp / msdos / xlib / sgrab10 / sgrab.doc < prev    next >
Encoding:
Text File  |  1994-10-05  |  4.3 KB  |  127 lines
  1.  
  2.             THE SPRITE GRABBER v1.0
  3.             -----------------------
  4.               1994, Pablo Fuentes
  5.  
  6.  
  7.     This is a small utility I made because I was getting tired of all 
  8. the work I had to do in order to draw bitmap images and then converting
  9. them into a format that enables me to use them in my programs.
  10.  
  11.     What SPRITE GRABBER does is load a graphic image up to 360x480
  12. pixels large in modeX and lets you GRAB one or more sprites from that
  13. image and save them in Xlib's Planar Bitmap (PBM) format.
  14.  
  15.     To quickly see how SGRAB works just run the sprite demo by
  16. simply typing: PACDEMO   
  17.  
  18.  
  19.  
  20. USING THE SPRITE GRABBER
  21. ------------------------
  22.  
  23.     Let's say that you make a PCX image with a drawing program which
  24. contains a series of drawings of a man walking. Just run SPRITE GRABBER
  25. with the PCX filename as an argument and it will load it and show you a
  26. rectangle on the center of the screen. You can then move the rectangle
  27. around, resize it to your liking and GRAB the drawings. Each drawing will 
  28. be saved as a PBM file which you can reload with a press of a button.
  29.  
  30.     Now you exit the program and restart it loading a new image this 
  31. time (say in GIF format) which is going to be your background image. You 
  32. can then press ALT-L to load a masked version of your sprites on top of 
  33. your backgroung to see how they look or to try out the animation aspects 
  34. of the sprites (by pressing ALT-L repeatedly). Beware though that the 
  35. sprites will be displayed using the new palette, so make sure the palettes 
  36. are compatible. After that, keep the sprites you liked most and use them 
  37. in your program by simply loading them.
  38.  
  39.  
  40.  
  41. FEATURES
  42. --------
  43.  
  44.  * Loads images in Compuserve GIF, Deluxe Paint LBM and BBM, PCX
  45.    and PIX formats.
  46.  * Images up to 360x480 pixels in size with up to 256 colors.
  47.  * Grab sprites as large as 100x100 pixels.
  48.  * Reload and display sprites in normal or masked mode.
  49.  * Mouse and keyboard supported.
  50.  * Source code available.
  51.  
  52.  
  53. REQUIREMENTS
  54. ------------
  55.  
  56.  * 80286 IBM-PC or 100% compatible with at least 512K of RAM
  57.  * VGA card and monitor capable of displaying 320x200x256c images
  58.  * A Floppy Disk or Hard Disk with enought space for the saved sprites.
  59.  * Mouse recommended
  60.  
  61.  
  62. DISTRIBUTION
  63. ------------
  64.  
  65.     You can freely distribute this program to anyone as long as you
  66. don't charge anything for it (who'd want to pay for this anyway?).
  67.  
  68.     Please be aware that this program is delivered as is, with no
  69. warranty whatsoever. Therefore I will not accept any responsibility for
  70. any damage that might be caused by this software.
  71.  
  72.     The C source for this program is available but not included in 
  73. this package. You can get the source code as well as updates for this
  74. program by anonymous FTP from "ftp.droit.umontreal.ca" in the directory
  75. "/pablo". 
  76.  
  77.  
  78.  
  79. SPRITE GRABBER USAGE
  80. --------------------
  81.  
  82. Here's the command line syntax:
  83.  
  84. sgrab <filename.ext> [Sprite_Width] [Sprite_Height]
  85.  
  86.   4 ≤ Sprite_Width  ≤ 100 pixels  (Multiple of 4)
  87.   1 ≤ Sprite_Height ≤ 100 pixels
  88.  
  89.  
  90. To move the rectangle, simply move your mouse around or use the keyboard
  91. arrow keys. Use ALT+arrow keys for faster movement.
  92.  
  93. Here's a list of the keys used:
  94.  
  95.       H: Call the HELP screen (Right mouse button)
  96.       S: Save a sprite in PBM format
  97.       L: Load the next sprite and display it
  98.   ALT+L: Display the next sprite in masked mode
  99.       R: Resize or stop resizing the working rectangle (Left mouse button)
  100.     ESC: Quit
  101.  
  102.  
  103. ACKNOWLEDGEMENTS
  104. ----------------
  105.  
  106.     Most of the 'real' code in this program was borrowed from sample code
  107. I picked up here and there. This includes the ModeX graphics library and most
  108. of the picture loading routines. So I would like to acknowledge the authors.
  109.  
  110.     I wish to thank Themie Gouthas for his great ModeX graphics library
  111. (Xlib) and Lary Myers for his ACKIFF utility to load Deluxe Paint LBM and BBM
  112. formatted images (from his ACK3D kit). Another aknowledgement to Shawn Knight
  113. for his PCX loading routine (from PCX2IMG) that was apparently borrowed from
  114. somebody else whom I also would like to acknowledge. Finally, thanks to the
  115. author of the GIFDCD.C code (whoever he is).
  116.  
  117.  
  118.  
  119. Please send comments, suggestions or source code requests to:
  120.  
  121.     Pablo Fuentes
  122.     6508 Drolet
  123.     Montreal, Quebec
  124.     Canada H2S 2S8
  125.  
  126.     Email : fuentesp@lazio.droit.umontreal.ca
  127.